home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wc3x / ffeed31.zip / FFEED31.TXT < prev    next >
Text File  |  1992-05-04  |  9KB  |  267 lines
  1.                                 ForceFeed
  2.                                Version 3.1
  3.  
  4.                              A DoorFrame Door
  5.                             
  6.  
  7.                                Written by
  8.  
  9.                               Shawn McGill
  10.                              The IMPROV BBS
  11.                              (502) 893-8102
  12.                                  USR/DS
  13.  
  14.                               Wildcat 3.01
  15.  
  16.                              April 26, 1992
  17.  
  18.  
  19. I hate writing Docs, so I'll keep this as short and sweet as possible.
  20. Forcefeed was conceived as a way to make my new callers download my
  21. application file that is required for access to the IMPROV BBS. 
  22.  
  23. Despite several screens telling them that I required them to download
  24. the file, many still did not. Some because they weren't about to, but
  25. some were simply new modemers, and didn't have the vaguest idea what a
  26. download even was!
  27.  
  28. I decided to write a door that would force them to download the
  29. application file, and Forcefeed was born. I use it as a menu hook off
  30. the main menu. My new callers have only three choices: they can Press
  31. [G]oodbye, [C]omment, or [A]uto-Application Download.
  32.  
  33. If they select "A", they enter this door, which leads them through the
  34. download procedure, and sends them the file. If they successfully
  35. download it, their security profile is upgraded, and the size of the
  36. file is added to their user record KBytes total, as well as one file.
  37.  
  38. When they come back out of the door after a successful download, they
  39. re-enter the system as a temporary user. If they did not successfully
  40. download the file, they are given another chance. If the file is not
  41. sent, no changes are made, and they're still looking at that 3-option
  42. new user main menu.
  43.  
  44.  
  45. WARRANTY:
  46.  
  47. None. I don't guarantee anything about this software. It may not even
  48. run. It is running on several systems beautifully, including my own,
  49. but I don't guarantee that it will on yours. I won't even guarantee 
  50. that it won't trash all your datafiles, and render your hard drive
  51. unusable for the next three generations. All I can tell you is that 
  52. it hasn't hurt mine. In other words, you are using this software entirely
  53. at your own risk. There are no warranties expressed or implied.
  54.  
  55.  
  56.  
  57. SETUP:
  58.  
  59. The setup of this door is a little unusual, but nothing too bad. The
  60. following steps should have you up and running in no time (I hope!)...
  61.  
  62.  
  63. Step 1.
  64.  
  65. Create a directory and unzip all the files in this archive into it.
  66.  
  67.  
  68. Step 2.
  69.  
  70. Edit the following files:
  71.     
  72.  
  73.     FFEED31.CFG
  74.  
  75.     The FFEED31.CFG file's name is not critical, since you will pass
  76.     it to the program on the command line, but it must contain the
  77.     following lines:
  78.  
  79.         Full path to DOOR.SYS
  80.         The BBS's Name
  81.         Sysop's First Name
  82.         Sysop's Last Name
  83.         Full path to USERINFO.DAT
  84.         The name of your application file
  85.         The security profile name you want to upgrade to
  86.         The Full path/name of the display file created
  87.         
  88.  
  89.     Optionally, you can run FFINSTAL.EXE from your door directory, and
  90.     this CFG file will be created for you.
  91.  
  92.  
  93.     As you can see, it's much like every other door you
  94.     ever set up, except that it looks for DOOR.SYS and USERINFO.DAT
  95.     instead of CALLINFO.BBS.
  96.  
  97.     Let me offer a couple of hints at this point. First, you could
  98.     simply path the door to your application file if you didn't
  99.     want to for some reason. The line that holds the name of your
  100.     registration file could just as easily be a complete pathname.
  101.  
  102.     Secondly, if you don't want a bulletin created of who's been
  103.     successfully through the process, just put any filename on that
  104.     line, and delete that file in your calling batch file when you
  105.     return from the door. Foe example, you could enter BOGUS.TXT on
  106.     that line, and make the last line of your calling batch file
  107.     delete it every time it runs. 
  108.  
  109.     You can also delete FFEED.DAT, which is created by ForceFeed to
  110.     keep track of the door's transactions, if you don't want to
  111.     maintain a display screen. I reset my ForceFeed door every month by
  112.     simply deleting the FFEED.DAT file on the first of each month.
  113.  
  114.  
  115.  
  116.     A sample FFEED31.CFG file might look like this:
  117.  
  118.  
  119.         C:\WC30\WCWORK\NODE1\DOOR.SYS
  120.         The IMPROV BBS
  121.         Shawn
  122.         McGill        
  123.         C:\WC30\WCWORK\NODE1\USERINFO.DAT
  124.         IMPROV.APP
  125.         TEMPORARY
  126.         C:\WC30\DISP\HELLO1N.BBS
  127.  
  128.  
  129.     MAIN1.RUN
  130.  
  131.     This is the batch file that calls ForceFeed from your main menu
  132.     "hook". Of course, it could also be run from the doors menu
  133.     (DOORx.RUN), or from the File menu (FILEx.RUN) or Message Menu
  134.     (MSG1.RUN), but that kind of defeats the purpose, doesn't it?
  135.  
  136.     Anyway you choose to run it, it's pretty straightforward. 
  137.  
  138.         CD\FFEED (or whatever directory you created)
  139.         FFEED31 FFEED31.CFG
  140.  
  141.     That's it! This file (if it's a "RUN") should be in your node
  142.     directory. If you elected to make it a "BAT", then put it in
  143.     your main WC directory (eg. c:\WC30).
  144.  
  145.  
  146. STEP 3.
  147.  
  148. Since FFEED uses Zmodem protocols, you must have DSZ.EXE or DSZ.COM in
  149. your FFEED directory. I suppose you could simply have it somewhere on
  150. your path, but I have only run this door with a copy of DSZ in the same
  151. directory, and since it worked, I didn't try it anywhere else.
  152.  
  153. The final step is to edit your AUTOEXEC.BAT to include the following line:
  154.  
  155.         SET DSZLOG=C:\FFEED\DSZLOG.LOG
  156.  
  157. This is very important, as it activates DSZ's log function, and FFEED
  158. uses this log to determine whether the caller successfully downloaded
  159. the file you have specified. Remember that you must reboot after making
  160. this edit for it to take effect.
  161.  
  162. The path in the SET statement above is intended to path to the
  163. directory you created for ForceFeed. We want DSZ to create the log in
  164. the ForceFeed directory, so make the above line point to the directory
  165. you created for the ForceFeed files! The log file must be called
  166. DSZLOG.LOG, though!!!
  167.  
  168. DSZ is the property of Omen Technology, INC, and in my opinion is the
  169. finest transfer protocol driver available. It is available for download
  170. on most every BBS in the country, if you don't already have a copy of it.
  171. I encourage you to register your copy of DSZ, although this door will
  172. run with the features available in the shareware versions.
  173.  
  174.  
  175. To recap, the following files should be found in your Door directory:
  176.  
  177.         FFEED31.EXE
  178.         FFEED31.CFG
  179.         Your Application File
  180.         DSZ.EXE or DSZ.COM
  181.  
  182. The Batch file that you call the door with should be in your main WC30
  183. Directory if it's a ???.BAT file, and in your node directory if it's a
  184. ???.RUN file.
  185.  
  186. HISTORY
  187.  
  188. The original Catpatch version was released on April 5, 1992. It had
  189. some problems on non-standard platforms, probably because of the
  190. Catpatch routines, themselves.
  191.  
  192. Version (3.1) was released on April 26, 1992. I rewrote the door, this
  193. time using DoorFrame routines. This was done in an effort to give it
  194. some improved I/O routines, and wider compatibility. Non-standard IRQ's
  195. are now supported, along with much higher baud rates.
  196.  
  197.  
  198. SUPPORT
  199.  
  200. I will support this door through my BBS, The IMPROV at (502) 893-8102
  201. (USR/DS). I am also a member of ThrobNet (known as "Al Bundy"). I also
  202. call the MSI Support Board on a regular basis.
  203.  
  204. REGISTRATION
  205.  
  206. This door will expire on 08/01/92. That should be sufficient time to
  207. see if it will run on your system, and whether it meets your needs.
  208. After a reasonable evaluation time, you must either register it, or
  209. delete it from use on your system.
  210.  
  211. Registration is $20.00.
  212.  
  213. Those who register will receive a copy without the expiration routines,
  214. and their name and registration number will be included on the initial
  215. intro screen. Registered users will also be entitled to any future
  216. versions of this program, which will be available for download on my
  217. BBS at HST speeds.
  218.  
  219.  
  220. ------------------------------ Tear off Here ----------------------------------
  221.  
  222.  
  223.                             ForceFeed Registration
  224.  
  225.  
  226. Name:________________________________________
  227.  
  228.  
  229. BBS NAME:____________________________________
  230.  
  231.  
  232. BBS PHONE:___________________________________
  233.  
  234.  
  235. Mailing Address:______________________________________________
  236.  
  237.  
  238. City:_____________________________________ State:_____________________
  239.  
  240.  
  241. Date:_______/_______/________
  242.  
  243.  
  244. Please enter a name so I can pre-register you on my BBS:
  245.  
  246.  
  247.     NAME:_____________________________________
  248.  
  249.     PASSWORD:_________________________________
  250.  
  251.     D.O.B:_______/_______/_______
  252.  
  253.  
  254. Registration: $20.00  Please check one:   Check_____    Money Order_______
  255.  
  256.  
  257. Make Payable to:
  258.  
  259.     Shawn McGill
  260.     P.O.Box 6148
  261.     Louisville, KY
  262.         40207
  263.  
  264. Thanks for supporting Shareware!
  265.  
  266.  
  267.